lsenclosurebattery

使用 lsenclosurebattery 指令,可顯示電池的相關資訊。電池位於節點機匣中。

語法

讀取語法圖表略過語法圖表 lsenclosurebattery -nohdr-filtervalueattribute_value-filtervalue?-delimdelimiter-batterybattery_idenclosure_id

參數

-nohdr
(選用)依預設,會在簡要樣式視圖中顯示每個資料直欄的標題,以及在詳細樣式視圖中顯示每個資料項目的標題。-nohdr 參數會暫停顯示這些標題。
註: 如果沒有要顯示的資料,就不會顯示標題。
-filtervalue attribute=value
(選用)指定一或多個過濾器的清單。只會傳回其值符合過濾器屬性值的物件。如果指定容量,也必須包括單位。
註: 某些過濾器容許您在輸入指令時使用萬用字元。當您在 CLI 中使用萬用字元時,會套用下列規則:
  • 萬用字元是星號 (*)。
  • 指令最多可包含一個萬用字元。
  • 使用萬用字元時,必須用雙引號 ("") 將過濾項目引起來,如下所示:
    lsenclosurebattery -filtervalue "battery_id=1"
-filtervalue?
(選用)顯示 -filtervalue attribute=value 參數的有效過濾器屬性清單:
  • battery_id
  • charging_status
  • enclosure_id
  • end_of_life_warning
  • percent_charged
  • recondition_needed
  • status
-delim delimiter
(選用)依預設,簡要視圖中的所有資料直欄都以空格區隔。每個直欄的寬度都會設為各資料項目的最大寬度。詳細視圖會在資料所在的列中提供此資料的每一個項目,如果要顯示標頭,則會用空格來區隔資料與標頭。-delim 參數會置換此行為。-delim 參數的有效輸入為一個單位元組字元。如果您在指令行輸入 -delim :,則會用冒號字元 (:) 來區隔簡要視圖中的所有資料項目;例如,直欄不會出現間距。在詳細視圖中,會用指定的定界字元來區隔資料與其標頭。
-battery battery_id
(選用)提供指定電池的詳細視圖。必須指定機箱,才有效。
enclosure_id
(選用)列出指定機箱的電池。

說明

這個指令顯示位於節點機匣中之電池的相關資訊。在簡要視圖中,每個機箱的 每一個電池機槽都會顯示一行,不論該機槽中是否有電池存在。擴充機箱不顯示電池。
此表格顯示可能的輸出。
表 1. lsenclosurebattery 輸出
屬性 說明
enclosure_id 識別含有電池之機箱的身分。
battery_id 識別機箱中的電池。
status 識別電池的狀態:
  • online 表示電池存在,且正常運作。
  • degraded 表示電池存在,但未如常運作。
  • offline 表示偵測不到電池。
recondition_needed 指出電池需要重新續電,或必須盡快開始重新續電。
記住: 如果一直出現此訊息,可能發生妨礙開始重新續電的錯誤。
percent_charged 指出電池電量(百分比)。
end_of_life_warning 指出電池壽命結束(有警告聲)。值為 yesno
重要: 更換電池。
FRU_part_number 指出電池的 FRU 產品編號。
FRU_identity 指出 11S 編號(製造產品編號與序號的組合)。
firmware_level 安裝在電池上的微碼映像檔版本。
error_sequence_number 指出此物件最高優先順序錯誤的錯誤日誌(或事件日誌)號碼。此輸出欄位通常是空白的。不過,如果發生問題(例如,狀態為 degraded),則會包含該錯誤事件的序號。
remaining_charge_capacity_mAh 指出電池的剩餘電量,以毫安/小時 (mAh) 計算。
full_charge_capacity_mAh 指出電池充飽電後的電量 mAh(此值會隨電池年限而降低)。
compatibility_level 指出電池驅動程式軟體必須支援此層次,才能操作此電池 - 此值來自電池重要產品資料 (VPD)。
last_recondition_timestamp 指出前次電量計校準成功的系統時間戳記,格式為 YYMMDDHHMMSS,其中:
  • Y 是年份
  • (第一個)M 是月份
  • D 是日期
  • H 是小時
  • (第二個)M 是分鐘
  • S 是秒
powered_on_hours 指出電池在已供電節點(未必是相同節點)中的小時數。
cycle_count 指出在電池上執行充電或放電循環的次數。

簡要呼叫範例

lsenclosurebattery 1

結果輸出:

enclosure_id battery_id status charging_status recondition_needed percent_charged end_of_life_warning 
1            1          online idle            no                 100             no                  
1            2          online idle            no                 100             no 

詳細的呼叫範例

lsenclosurebattery -battery 1 1

結果輸出:

enclosure_id 1
battery_id 1
status online
charging_status idle
recondition_needed no
percent_charged 100
end_of_life_warning no
FRU_part_number 31P1807
FRU_identity 11S00AR085YM30BG42R04P
firmware_level 105:1
error_sequence_number 
remaining_charge_capacity_mAh 3477
full_charge_capacity_mAh 3795
compatibility_level 1
last_recondition_timestamp 140528045617
powered_on_hours 1162
cycle_count 10